---
title: v5'e Yükseltme
description: Projenizi Ultracite v4'ten v5'e nasıl yükselteceğiniz.
---

Ultracite v5, önemli iyileştirmeler ve geriye dönük uyumsuz değişiklikler içeren büyük bir sürümdür. Bu kılavuz, mevcut v4 kurulumunuzu v5'e yükseltmenize yardımcı olacaktır.

## v5'te Yenilikler

- **Güncellenmiş Biome**: v1.x'ten v2.x'e yükseltildi
- **Yeni Yapılandırma Biçimi**: `biome.json`'dan `biome.jsonc`'ye geçiş
- **Geliştirilmiş CLI**: TypeScript ile yeniden yazıldı ve hata yönetimi iyileştirildi
- **Editör Entegrasyonları**: Cursor, Windsurf, Zed ve GitHub Copilot için yerleşik destek
- **Git Kancaları**: Husky, lint-staged ve lefthook dahil isteğe bağlı entegrasyonlar
- **Geliştirilmiş Şema**: Daha iyi doğrulama ile yeni şema URL'si
- **Basitleştirilmiş VS Code Ayarları**: Dosya türü geçersiz kılmaları tek satırda birleştirildi

## Geçiş Adımları

### Otomatik Geçiş (Önerilir)

Geçiş yapmanın en kolay yolu yeni başlatma komutunu çalıştırmaktır:

```package-install
npx ultracite@latest init
```

Bu şunları yapacaktır:
- Bağımlılıklarınızı en son sürümlere güncelleyecek
- `biome.json` veya `biome.jsonc` dosyanızı güncelleyecek  
- VS Code ayarlarınızı güncelleyecek
- AI editör kuralları (Cursor, Windsurf, Zed vb.) kurmayı teklif edecek
- Yeni entegrasyonları (Git kancaları, lint-staged vb.) kurmayı teklif edecek

Yükseltme sonrasında, varsa geçersiz kılmaları kaldırmak için `biome.json` / `biome.jsonc` dosyanızı gözden geçirmeniz ve yeni yapılandırmanın uygulandığından emin olmak için editörünüzü yeniden başlatmanız önerilir.

Ayrıca şema / kural değişiklikleri hakkında daha fazla bilgi için Biome [v2 yükseltme rehberini](https://biomejs.dev/guides/upgrade-to-biome-v2/) inceleyin.

### Manuel Geçiş

Sürecin üzerinde daha fazla kontrol sahibi olmak isterseniz, [Manuel Geçiş](/setup#manual-installation) adımlarını izleyin:

- Ultracite ve Biome'ın güncellenmiş sürümlerini elle kurmak
- `biome.json` dosyanızı yeni şema sürümüne güncellemek
- `.vscode/settings.json` dosyasını güncellemek (isteğe bağlı)
- Bir AI editör kuralları dosyası eklemek (isteğe bağlı)
- Yeni entegrasyonlar eklemek (isteğe bağlı)

Geçiş tamamlandıktan sonra, yeni yapılandırmanın uygulandığından emin olmak için editörünüzü yeniden başlatın.